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I* INTRODUCTION TO FIX 


Fix is an assenbla language utilita to exanine and nodifa 
disk files* All nunbers outputted ba and entered to FIX are 
hexidecinal. The Ctrl 1 kea can be used to start and stop the 
data displaa on the screen* 


II. FILE STRUCTURE 


Diskettes are divided into blocks of data called sectors* 
The ATARI 810 has 720 sectors.of 128 bates* The ATARI .815 
has 720 sectors of 256 bates* Diskettes have four parts* 


1* BIT MAP* The bit nap contains infornation on the 
status of each sector* Ba exanining the Bit Map the 
File Manager can deternine if a sector has been 
allocatedfin use) or not(free)* 

2* DIRECTORY* The directora sectors contain 
infornation on the nanes* location* length* and status 
of the files on a diskette. 

3* BOOT SECTORS. Each diskette contains 1 or 3 sectors 
reserved for infornation read on power-up* These 
sectors are nornalla inaccessable to the user when 
using the File Manager. All 9/24/79 DOS diskettes use 
sectors 1 for the boot* All DOS II 2S or 2D diskettes 
use sectors 1*2 and 3. 

4* DATA SECTORS* The rest of the sectors are used to 
store the infornation in the files* Most of the bates 
of a sector are dedicated to the actual file 
infornation* The last three bates of every sector 
contains "house-keeping*' infornation for the File 
Manager. 

FILES are nade up of a DIRECTORY ENTRY and a set of one 
or nore sectors* The sectors are usualla contiguous but do 
not have to be* For a conplete description of a directora 
entra see section III*A 
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III. MENU ITEMS 


FIX is a nenu driven progran. To execute connands/ 'type 
the letter in front of the connand listed in the displayed 
nenu(see Fig. 1>. 

You do not need to type <RETURN>. FIX autonatically accepts 
your connand and replies with the pronpt for that connand. If 
you have inadvertantly typed the wrong connand, hit the 
<BREAK> key to abort the connand. 

A* Directory Entries. 


This nenu iten will display the entries in the directory. 
Fig.1 shows the user requesting FIX to display the first 
8(hex) entries. Notice that the entries start with 0. The 
directory nay contain a naxinun of 64 files. Single entries 
nay be displayed by sinply typing the file nunber and <RETURN>. 

The left nost colunn gives the file nunber of each file 
displayed. The next colunn is the filenane and extension. 
Notice that the period is onitted in the file nane. The next 
colunn* labelled FSEC, is the first sector in the file. The 
♦SEC Colunn gives the nunber of sectors in the file. Both 
nunbers are hexadecinal. 

The last colunn* DL* gives the status of the file. 

Notice in Fig. 2 that file 4(FIX6> has a D. This neans that 
the file has been deleted fron the directory. Since it the 
first available "hole*' the next file created will occupy its 
directory entry. 

File 3(MYPR0G.BAS> has an L. The L indicates that the 
file is locked. Also notice that files 5-8 are enpty 
directory entries* containing no directory entries. 

A 

B. Trace Sector Chain 


This nenu iten will verify the structure of a file. It 
traces the file through all of its sectors until it hits end 
°f file or a bad link. A link is a pointer to the next sector 
of a file. A bad link is a link to a sector that belongs to 
another file. An end of file is a link that points to the 
sector 0. 

Fig.3 shows the sector chain for the snail BASIC file 
MYPROG.BAS. Notice that we are tracing file nunber 3. The 
file nunber is the entry nunber into the directory. 
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The GS column has two different Meanings* depending on 
the DOS that created the file* The 9/Z4 DOS A used this 
nunber as the relative sector nunber. For the first sector in 
a file this should be 1* Subsequent sectors should add 1 to 
this nunber* If you notice that nunbers are skipped* this nay 
indicate that the links in your file nay have becone bad* 

The last sectors. BS is the nunber of bytes in the sector* 

For DOS II the BS indicates the nunber of bytes in each 
sector* Most sectors should contain *7D bytes(128 byte single 
density disk) or $FD bytes(256 bytes double density disk)* 

The last sector in a file is usually less then the above 
nunbers* 

Appending one file to another will cause the byte count 
in the sector inbetween the appended portions to be less then 
full • It is therefore possible to have partially filled 
sectors in the niddle of a file • 

The last colunn* FP» is the forward pointer* This is the 
link to the next sector of the file* Files on newly fornatted 
diskettes tend to be linked sequentially* Files on diskettes 
■that have several files that have been deleted tend to becone 
"fractured". This neans that the files tend not to be 
sequentially linked* In other words the sectors are not 
physically contiguous* 


C. Modify Directory Entry 


You can use this nenu iten to nake changes to the 
diskettes directory* Enter the file nunber of the entry you 
wish to change followed by <RETURN>. 

Fig* 4 shows the user is naking a change to directory 
entry 3* FIX has printed the directory iten and positioned the 
cursor to the filenane* * 

At this point you can edit the filenane* the starting 
sector nunber* the nunber of sectors* or the status of the 
file* By inserting or deleting the D you can delete or 
"un-delete" the file* By adding or deleting the L you can 
lock or unlock the file* See section III*A for the neaning of 
the rest of the info on the line* 

If you wish to have FIX update the entry* then type 
<RETURN>* If you don't want the entry updated* then type 
<BREAK>, 
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D« Check. Allocation Map 


This nenu item can recover sectors that have become 
nis-allocated* To run it type D* FIX automatically starts 
Making it's own BIT MAP* It will link thru all the files and 
nark all the sectors in use and those that are free* FIX then 
compares it's BIT MAP to the BIT MAP on the diskette* All 
sectors that should be free but aren't are printed as “MARKED 
IN USE"* All sectors that are really allocated to a file but 
aren't in the diskettes BIT MAP are narked "FREE". Sectors 
that are correctly allocated are not printed* 

After FIX has checked all the sectors it will exit back 
to the menu if all sectors are correct* If some sectors are 
nis-allocated it will ask you to if you want to write it's 
correct copy to the diskette* Just type "Y" to do so* If you 
don't want to write the corrected BIT MAP to be written .to the 
disk then type <RETURN>* 

Fig* 5 shows the result of a D command* Notice that we 
had a bad link in file 0(the first file)* This will usually 
cause an error 164 when you attempt to read the file* Me 
would probably want* to trace its sector chain (B command) to 
find the bad link* 

Our bit nap seems to be slightly mangled also* so we 
would type Y to rewrite our new bit nap* 


E» Modify Sector Link 


You may have discovered that some of your sector links 
have been altered incorrectly* This menu item allows you to 
change the links in the sectors on the diskette* After you 
type E * FIX will prompt you to enter the sector number to 
modify* Enter the hex sector number followed by <RETURN> 

Fix then prints the sector link information from the 
sector on the diskette* FIX positions the cursor on the line* 
Using the cursor control keys* you can alter the file number 
this sector is allocated to* the number of bytes in this' 
sector of the file, and the FORWARD POINTER* Typing an E to 
the right of the FORWARD POINTER will mark this sector as End 
of File* 

To tell FIX to write out the updated info to the sector 
simply type <RETURN>* If you realize that you have made an 
error in trying to modify this sector* position the cursor 
below the line and type <RETURN>* FIX will then re-display 
the line* Type <RETURN> to exit*. 
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See section III,B for nore info on the sector link 
display* 


F* Set Drive Nunber 

This nenu iten sets the drive nunber* Type the drive nunber 
(1-8) and <RETURN>* Fig* 7 shows a user setting the drive 
nunber to 1 (FIX defaults to drive 1 upon loading)♦ 


GJ Exit To Dos 


This iten causes a return to DOS 
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IV* ERROR CODES AND RECOVERY 


ERROR * DESCRIPTION 


128 BREAK KEY ABORT 

This is caused by typing <BREAK>* 


12? IOCB ALREADY OPEN 

The IOCB is already open* 

Recovery* You can CLOSE the IOCB and re-OPEN it* You can 
use the current IOCB* You nay want to check and see why 
the IOCB is OPEN* 


130 NON EXISTENT DEVICE 

You have tried to access a device not in the handler tablet 
ie* the device is undefined* The handler nay be loaded in 
nenory but not initialized* This error nay occur when 
trying to access the ATARI 850 without running the RS232 
AUTORUN.SYS file. 

Recover* Check your I/O connand for the correct device* Or 
load and initialize the correct handler* 


131 IOCB WRITE ONLY ERROR 

You have attenpted to read fron a file opened for write 
only* 

Recovery* Open the file for read or read/write (update 
node)« 


132 ILLEGAL HANDLER COMMAND 

This is an CIO error code* The connand code passed to the 
device handler is illegal* The connand either <=2 or is 
a special connand to a handler that hasn't inplenented any 
special connands* 

Recovery* Check your XIO* or IOCB connand code for illegal 
connand code* 


133 DEVICE/FILE NOT OPEN 

Device or file not open* You have not OPENED this file or 
device* 

Recovery* Check your OPEN statenent or file I/O statenent 
for the wrong file specification. 
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34 INVALID IOCB NUMBER 

You have tried to use an illegal IOCB index* For BASIC? the 
range is 1-7* BASIC does not allow use of IOCB 0. The 
ASSEMBLER EDITOR cartridge requires the IOCB index to be a 
Multiple of 16 and less than 128* 


135 IOCB WRITE ONLY ERROR 

You have tried to write to a device/file that' is OPEN for 
read onls* 

Recovers* You could open the file for write or read/write* 


136 END OF FILE 

Your input file is at end of file* No nore data in file* 


137 TRUNCATED RECORD 

This error tspicalls occurs when the record sou are reading 
is larger then the Maxinun record size specified in the 
call to CIO* BASIC's naxinun record size is 11? bstes* 
Recovers* You probabls are trsing to use an 
INPUT(Record-oriented) tspe connand on a file that was 
created using PUT(bste-oriented) connands* 

Records in a file are delinited bs E0L(End Of Line) 
characters (S9B)» Files that are created using PUTs have 
no EOL unless the bstes sou output have a S9B* Trsing to 
read a PUT file with record I/O nas cause the DOS to read a 
record that is the size of the file* The DOS will then 
generate this error* Trs reading the file using PUT tspe 
statenents* 

This error nas also occur when ENTERing a BASIC 
progran created using SAVE* Trs LOADing the progran* 


138 DEVICE TIMEOUT a 

A connand was sent bs the conputer to a device device over 
the SERIAL BUS* The device did not respond within the 
period set bs the 0* S* for that particular device connand* 

This error can be caused in several wass* 

1* The device nunbef nas be wrong* 


Ex, OPEN #3?4? 0 f “D3JMYPR0G" 


You would get this error if disk drive 3 was not connected 
to the conputer? not turned on? or not present* 

2* The disk drive nas be present but is unable to execute 
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the command in the proper period of tine* 

Recovery* To recover from error case 1# examine the 
connections between the disk drive and the conputer to make 
sure the are properly secured* Check the drive to make sure 
it is powered on and set for the correct drive nunber. You 
should check your I/O command for the correct drive number* 
Retry the command* If you get this error again see the next 
line* 

The second type of timeout error is caused by an 
interaction between the 0* S* and the disk drive* DOS 
9/24*s timeout value was set too low for all possible cases 
of disk operations* The disk may have had some trouble 
executing the commmsnd in the short period allowed by the 
operating system* DOS II does not have this problem* 

The second type of timeout error is intermitent* You 
should be able to retry the operation and succeed* If this 
error occurs more then a few times* the device may need 
repair* 


13? DEVICE NAK 

This error is a sort of catch all error code* The device 
may have received a valid command but can't execute it 
because of bad parameters* For example* trying to read an 
unaddressable sector* such as sector 0* The device may have 
recieved a garbled command or data frame from the computer* 
Recovery* Check your I/O command for illegal parameters* 


140 SERIAL FRAME ERROR 

Bit 7 of SKSTAT in POKEY is set* This means communications 
from the device to the computer is garbled* Specifically* 
POKEY detected missing or extra bits in a byte received on 
the SERIAL DATA BUS* 


141 CURSOR OUTRANGE * 

Your cursor is out of range for this particular graphics 
mode* 


142 SERIAL OVERRUN 

Bit 5 of SKSTAT in POKEY is set*The computer did not 
respond fast enough to a SERIAL BUS input interupt* POKEY 
recieved another 8-bit word on the SERIAL BUS before the 
computer could process the previous word received* 
Recovery* This is a rare error* If it recurs you should 
have your computer serviced* 
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143 CHECKSUM ERROR 

Serial Bus communications are screwed up. The checksum sent 
by device is not the sane as that calculated for frame 
received by computer. 

Recovery: Not ouch you can do about this. Could be hardware 
or sortware problem in device/computer. 


144 DEVICE DONE ERROR 

The device is unable to execute a valid command. There are 
two causes of this error. Usually it means you have tried 
to write to a write protected device or diskette. This is 
easily corrected by removing the disk protect tab or 
turning the write protect switch on the 815 off. 

The second reason for this error appears unknown at 
this point.The disk drive is unable to read/write the 
sector requested or the cassette is set at the .wrong baud 
rate. 

Recovery} Remove write protect tab or turn off write 
protect switch. If the disk was not write protected, you 
may have problems with the diskette media. Don't know how 
to recover on cassette. 


145 READ AFTER WRITE COMPARE ERROR 

. You have tried to open the SCREEN EDITOR with an illegal 
graphics mode number. 

Recovery: Check GRAPHICS mode call or the AUX2 byte in the 
I0C8. 


146 FUNCTION NOT IMPLEMENTED 

Function not implemented in handler, ie. trying to PUT to 
the keyboard or issuing special commands to the keyboard. 
Recovery: Check I/O command for right command to correct 
device 

147 NOT ENOUGH RAM FOR SELECTED GRAPHICS MODE 
Insufficient RAM for graphics mode selected. 

Recovery: Add more memory or use a smaller graphics mode. 


160 DRIVE NUMBER ERROR 

You specified an out of range drive(not 1-8) or you have 
not allocated a buffer for this drive. 

Recovery: Check your file specification or byte 1802 (*710). 


161 TOO MANY OPEN FILES 

You don't have any free sector buffers to use on another 
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file* 

Recovery* You nay have up to 8 open files* Check location 
1801 (*709) for the nunber of sector buffers allocated* 


162 DISK FULL 

, You don't have any wore free sectors on this diskette* 

Occurs when writing to a full diskette* 

Recovery} Use a different diskette with free sectors* Use 
the D option on FIX to see if you have any nis-allocated 
sectors* At present there is no way to recover fron this 
error during progran execution* 


163 FATAL SYSTEM I/O ERROR 

This error code Means that the file Manager has a bug in 
it* If you get this error then please report it to CUSTOMER 
SERVICE* 


164 FILE NUMBER MISMATCH 

The structure of the file is danaged* One of the file links 
points to a sector allocated to another file* 

Recovery* Use B and E FIX coMMands to fix up the file 
links* You can not recover froM this error during progran 
execution* 


165 FILENAME ERROR 

Your file specification has illegal characters in it* Legal 
characters are alphnunerics*x, and ?« 

Recovery* Check file specification and renove illegal 
characters* 


166 POINT DATA LENGTH 

The byte count in the point call was greater then 125 
(single density) or 253 (double density 
Recovery* Check POINT statenent paraneters* 


167 FILE LOCKED 

You tried to access a locked file* 
Recovery* Unlock file* 


168 DEVICE COMMAND INVALID 

Probably Means device didn't recognize connand* 
Recovery* ????? 


169 DIRECTORY FULL 


-10- 




FIX Reference Manual 1*0 


170 


171 


172 


173 


You don't have any free entries in the directory. 
Recovery? See A and C FIX connands* 


FILE NOT FOUND 

You have tried to access a file that doesn't exist in the 
diskettes directory* 

Recovery? Usually you have Mistyped the file spec* Look at 
the directory usin9 the DOS A connand for the correct nane* 


POINT INVALID 

You've probably tried to POINT to a byte or record beyond 
the end of the file* 

Recovery* Check size of file against the POINT value* 


ILLEGAL APPEND 

You have tried to OPEN a DOS I file for append using DOS 
II* DOS II cannot append to DOS I files* 

Recovery: Copy the DOS I file to DOS II diskette using DOS 
II. 


BAD SECTORS AT FORMAT 

The disk controller detected bad sectors while FORMAT'ing a 
diskette* 

Recovery* Throw away the diskette and use another* If you 
caanot FORMAT a diskette* the disk drive nay need repair* 


a 
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FXXDUMP 2SD CO . ATARI . INC 

a: " Directory ’ entries ^. rfi ,T1 'r^ w 1 *" 1 T 1 

B: TRACE SECTOR CHAIN ‘ _ - -- - . __ 

CS MODIFY DIRECTORY EllTRY1^*SSf*^: : 
»i CHECK ALLOCATION MAP 
El.- MODIFY SECTOR LXMK^j 
FS 1 SET DRIVE NUMBER :K:L" 

68 • EXIT TO OOS>rs- -'V Vi-v ' i trr; 

••i - :\iiA :! ,4- :Kf -i : -; ? i --ri/-!, .[• -VI % i •’ • r 1* ; 


SELECT ITEM OR iMiirJ!! FOR MENU 1 


! nl 


r ■> '• 't ,'j . <■. 

• Fta. M ‘ I 1 r 

• J . J ; i '. 1 r & 


u-s 


FIRST*LAST DIR ENTRIES TO SHOW? 
0*8 

DN FXLENAM EXT FSEC NSEC DL 

80 DOS SYS 0004. 0020 

OL DUP SYS 002A ©62A 

02 FXXO 0054. 002A . 

02 MYPROC BAS 007E OOOZ L 

04. FIXO 0054 0020 B * 

05 M tMHMW OOOO 6000 

eo o wmhu m w m eooe eooo 
67.0000^00 0 000 oooo eooe 
oo »»•»»»»»«»» oooo eooo 

SELECT ITEM OR HMIM3 FOR MEMO 


i-: Pa- 13 : 


’ : ^ 









i- {**: i : r • t _a 

.lAlff W POD MF'klll r r.-r-J 


ex MYPKOS BAS 807E Wi.'.'LrVS,^ 
SECTOR 07ES F*t=8i, BS-7D, FP=07Fu*J 
SECTOR 07F : . F*=eX, BS=7»,- ; FP=©88 T-a 
SECTOR 060: FS=87, BS=45, FP=600 E 




SELECT ITEM OR iMPED FOR MENU [ 


^c-V* 



SELECT ITEM OR aaiWiBI FOR MEND {■ 
MUCH ENTRY , TO MORIFYTVri .*• 

DU FXLEMAH EXT FSEC tSSEC OLF! n : 
ex Qyproc bas eo7E eeox L: ■■ 


11 i 

,vi. :-R M 
■;:T - -I 

1 ;4 1 

if • '-4 


&*»■$***»* 


SELECT ITEM OR lllstjHgM FOR HEHH 

buildukg allocation map...: 

BAB LINK IN FILE » 80 -i \ 
sector eei: m=ee, bs=8C„ FP=2ex 
NAS MARKER; IM-USE^i 
SECTOR 8041. FB=BBT>B=7 Bj*s£P= 8B5 
MAS MARKER.. FREE^dpilSpaAeR : 
SECTOR 8071 F8=BB^BS=7BOP=«B» 
MAS MARKER TO HS g*a**Ngfc« fi» . 
SECTOR 02A| Ftt=01, u BSs7Bi>>=82B 
NAS BtARKER~TREE*rfS££i§&HW 
SECTOR 82C: toT7M=7K^b=B» 
MAS MARKEBujrRE E> . >w t ui..l^ g^^^R • 
SECTOR~OX2| .nt=B^TB$^DW?=833 
fctA1>,r,r "- ' 3c f'4rrTf #^-iiitrig . 


jFP=0X3 






























